package com.ruoyi.ai.service;

import com.ruoyi.ai.domain.WxUser;
import com.ruoyi.ai.domain.vo.WxUserVo;
import com.ruoyi.ai.domain.bo.WxUserBo;
import com.ruoyi.common.core.page.TableDataInfo;
import com.ruoyi.common.core.domain.PageQuery;

import java.util.Collection;
import java.util.List;

/**
 * 微信用户Service接口
 *
 * @author ruoyi
 * @date 2024-03-23
 */
public interface IWxUserService {

    /**
     * 查询微信用户
     */
    WxUserVo queryById(Long wxUserId);

    /**
     * 查询微信用户列表
     */
    TableDataInfo<WxUserVo> queryPageList(WxUserBo bo, PageQuery pageQuery);

    /**
     * 查询微信用户列表
     */
    List<WxUserVo> queryList(WxUserBo bo);

    /**
     * 新增微信用户
     */
    Boolean insertByBo(WxUserBo bo);

    /**
     * 修改微信用户
     */
    Boolean updateByBo(WxUserBo bo);

    /**
     * 校验并批量删除微信用户信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 通过openid查询信息，很多场景会用到
     * @param openid
     * @return
     */
    WxUser queryByOpenid(String openid);

    /**
     * 通过unionId查询信息，公众号场景会用到
     * @return
     */
    WxUser queryByUnionId(String unionId);


    /**
     * 修改数量，部分字段如果为null会修改为null
     * 具体查看代码
     */
    Boolean updateNumWithNull(WxUserBo bo);
}
